home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 4 / Amiga Tools 4.iso / grafix / raytracing / raylab / docs / amiga.doc < prev    next >
Encoding:
Text File  |  1996-02-17  |  4.3 KB  |  106 lines
  1.  
  2.                               RayLab 1.0 for Amiga
  3.  
  4.                         (c)1995-1996 by Marcus Geelnard
  5.  
  6.  
  7. Contents:
  8. ---------
  9.  
  10. The Amiga distribution of RayLab contains the following:
  11.  
  12. · Two executables:   raylab881  - for Amigas with an FPU (and a 68020+)
  13.                      raylabieee - for any Amiga (68000+ without an FPU)
  14.  
  15. · The documentation for RayLab.
  16.  
  17. · Sample RayLab scenes.
  18.  
  19. · The sourcode for RayLab, including the Amiga specific code, a makefile for
  20.   SAS/C 6.x and the generic code/makefile for any platform.
  21.  
  22.  
  23. Installation:
  24. -------------
  25.  
  26. You may already have installed RayLab, if you are reading this. Otherwise,
  27. this is what you need to do: Extract all files from the RayLab lha-archive
  28. to a proper place on your harddisk (e.g. Work:Graphics/RayTracing/). If you
  29. have extracted the files to a temporary directory (e.g. RAM:), simply drag-
  30. and-drop the RayLab drawer icon to where you want it on your harddisk.
  31.  
  32. Also, it would be wise to create some new directories for your own use,
  33. especially one for your own scenes and one for pictures. For example:
  34.  
  35.          ..../RayLab/My_Scenes/
  36.          ..../RayLab/My_Pics/
  37.  
  38. This way it will be easier to keep track of your RayLab files.
  39.  
  40. Before you use RayLab, please finish reading this doc. Then proceed to reading
  41. 'raylab.doc' (you may want to have it on paper, as it contains much reference
  42. material about the usage of RayLab). Anyway, although there are icons for the
  43. RayLab executables, you will have to use RayLab from shell. RayLab was intened
  44. to be as portable as possible, and I mostly run it on a unix system (which is
  45. about 6000% faster than my A3000-28MHz) so I have not bothered to make any GUI,
  46. sorry.
  47.  
  48.  
  49. Amiga specific:
  50. ---------------
  51.  
  52. The Amiga version of RayLab can display a picture as it is being rendered. To
  53. make it do so, add the following to a globals section in your scene description
  54. (read 'raylab.doc' for more information):
  55.  
  56.         display x
  57.  
  58. ...where x is the display-mode. These are the currently supported display-modes
  59. for the Amiga:
  60.  
  61.   0  - No display  (default)
  62.   1  - HAM6, lowres, non-interlaced (dithered)
  63.   2  - Grayscale, hires, interlaced (dithered)
  64.  
  65. With the display turned on, the rendering will be slightly slower, but probably
  66. not enough for you to notice (a 320x240 HAM6 screen takes 20 seconds on an Amiga
  67. 3000, as compared to some potential 10-60 minutes of computing).
  68.  
  69. When the rendering is done, you are able to select 'Close' from a menu on the
  70. screen (by pressing the right mouse-button). This will close the display and
  71. exit RayLab. The menu will not appear until the picture is completed. If you
  72. did not open a display (or if RayLab was unable to open one), RayLab will just
  73. exit when it is done rendering.
  74.  
  75. If you want to terminate RayLab during rendering, activate the shell-window
  76. from which you started RayLab, and press CTRL-C. RayLab will then cleanup and
  77. exit gracfully, but your picture will only be 'half-done'. This means a corrupt
  78. picture file, and you have to start all over if you want to render it again.
  79.  
  80. Often you may just want a preview of a scene. The simplest way should be to
  81. tell RayLab to display while rendering, and selecting NIL: as the output file.
  82.  
  83. I would like to add support for HAM8, but I only have ECS in my A3000, so I do
  84. not have any great experience in AGA screens (nor any possibility to test it).
  85. If anyone feels like helping out, you are very welcome to do so!
  86.  
  87.  
  88. Compiling on your own:
  89. ----------------------
  90.  
  91. If you would like to compile RayLab for the Amiga on your own, simply copy the
  92. Amiga specific code and the makefile from the source/platform/amiga directory
  93. to the source directory. If you use SAS/C 6.x, you just have to type smake when
  94. you stand in the source directory to compile RayLab for 68020/68881 Amigas.
  95. Please refer to the smakefile for more information about compiling RayLab for
  96. different machines. If you do not have SAS/C, or if you prefer to use another
  97. compiler, such as Gnu C, you will have to modify the makefile for your compiler.
  98. You may also be helped by the generic makefile for gcc/cc and/or the generic
  99. code (generic.c) found in source/platform/generic. Now you are on your own!
  100.  
  101. Please note that you may not spread a new compilation of RayLab without my
  102. permission! This is to avoid missunderstandings about who is responsible for
  103. supporting the users of your compilation. Read 'raylab.doc' for further info
  104. about legal issues...
  105.  
  106.